Skip to content

Conversation

luisquintanilla
Copy link
Contributor

@luisquintanilla luisquintanilla commented Sep 29, 2025

This pull request adds a new conceptual documentation page introducing agents and workflows in the context of .NET AI development. It also updates the table of contents to include this new page, making it easier for users to discover information about building agents.

Documentation additions:

  • Added a new conceptual documentation page docs/ai/conceptual/agents.md that explains what agents are, their capabilities, the role of workflows, and how to get started building agents in .NET using Microsoft.Extensions.AI and related SDKs.

Documentation navigation improvements:

  • Updated the AI documentation table of contents (docs/ai/toc.yml) to include a link to the new "Building Agents in .NET" page.

Fixes #48047.


Internal previews

📄 File 🔗 Preview link
docs/ai/conceptual/agents.md Agents
docs/ai/index.yml [linkListType: architecture
docs/ai/toc.yml docs/ai/toc

@luisquintanilla luisquintanilla requested review from gewarren and a team as code owners September 29, 2025 19:09
@dotnetrepoman dotnetrepoman bot added this to the September 2025 milestone Sep 29, 2025
@luisquintanilla luisquintanilla marked this pull request as draft September 29, 2025 19:09
@luisquintanilla
Copy link
Contributor Author

Trigger CI

@luisquintanilla luisquintanilla marked this pull request as ready for review October 1, 2025 17:32
@gewarren
Copy link
Contributor

gewarren commented Oct 1, 2025

For the build failure, it looks like there was previously a file with the same name that was removed, so you probably just need to remove that redirect.

@luisquintanilla
Copy link
Contributor Author

@gewarren looks like all builds are passing. Is there a way to render mermaid diagrams in docs?

This is what I see in preview -

image

@gewarren
Copy link
Contributor

gewarren commented Oct 1, 2025

Is there a way to render mermaid diagrams in docs?

No, I don't think so :( :( cc @IEvangelist who has also tried this.

@luisquintanilla
Copy link
Contributor Author

@gewarren no worries! Whenever you get a chance, this is ready for review and approval. Thanks!

luisquintanilla and others added 4 commits October 2, 2025 13:25
Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
@luisquintanilla luisquintanilla merged commit 7c64a38 into main Oct 2, 2025
10 checks passed
@luisquintanilla luisquintanilla deleted the agents branch October 2, 2025 19:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

New article: Overview of agents for .NET
3 participants